Repository navigation
Conversation
Also translates the embedded demo shown via [codetabs] (upload-resume.view/index.html, uploader.js, server.js), including comments and the HTTP status texts the server returns, since the demo is presented inline to the reader as downloadable code. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
| @@ -1,82 +1,82 @@ | |||
| # Resumable file upload | |||
There was a problem hiding this comment.
Importante: o título do artigo ficou sem tradução. Ele aparece no índice e no topo da página, então vale traduzir também. Uma sugestão, mantendo o termo "upload" que você já usa no restante do texto:
| # Resumable file upload | |
| # Upload de arquivo retomável |
| Como retomar o upload depois de perder a conexão? Não existe nenhuma opção nativa para isso, mas temos as peças para implementá-lo. | ||
|
|
||
| Resumable uploads should come with upload progress indication, as we expect big files (if we may need to resume). So, as `fetch` doesn't allow to track upload progress, we'll use [XMLHttpRequest](info:xmlhttprequest). | ||
| Uploads retomáveis devem vir com indicação de progresso de upload, já que esperamos arquivos grandes (se é que podemos precisar retomar). Então, como `fetch` não permite acompanhar o progresso de upload, vamos usar o [XMLHttpRequest](info:xmlhttprequest). |
There was a problem hiding this comment.
Detalhe (opcional): "se é que podemos precisar retomar" acrescenta um tom de dúvida que o original não tem. Em "(if we may need to resume)", o autor só explica que, com arquivos grandes, talvez seja preciso retomar o envio. Que tal assim?
| Uploads retomáveis devem vir com indicação de progresso de upload, já que esperamos arquivos grandes (se é que podemos precisar retomar). Então, como `fetch` não permite acompanhar o progresso de upload, vamos usar o [XMLHttpRequest](info:xmlhttprequest). | |
| Uploads retomáveis devem vir com indicação de progresso de upload, já que esperamos arquivos grandes (que talvez precisem ser retomados). Então, como `fetch` não permite acompanhar o progresso de upload, vamos usar o [XMLHttpRequest](info:xmlhttprequest). |
| ## Algoritmo | ||
|
|
||
| 1. First, create a file id, to uniquely identify the file we're going to upload: | ||
| 1. Primeiro, cria um id de arquivo, para identificar unicamente o arquivo que vamos enviar: |
There was a problem hiding this comment.
Detalhe (opcional): os passos do algoritmo são instruções ao leitor, e o texto trata o leitor por "você" (por exemplo, "você pode baixá-la"). Então o imperativo fica "crie" em vez de "cria". O mesmo vale para a linha 33: "Envie uma requisição ao servidor..." em vez de "Envia".
| 1. Primeiro, cria um id de arquivo, para identificar unicamente o arquivo que vamos enviar: | |
| 1. Primeiro, crie um id de arquivo, para identificar unicamente o arquivo que vamos enviar: |
| xhr.setRequestHeader('X-Start-Byte', startByte); | ||
|
|
||
| xhr.upload.onprogress = (e) => { | ||
| console.log(`Uploaded ${startByte + e.loaded} of ${startByte + e.total}`); |
There was a problem hiding this comment.
Detalhe (opcional): o texto deste console.log ficou em inglês, enquanto o mesmo trecho em uploader.js foi traduzido. Como textos dentro do código podem ser traduzidos, fica mais coerente assim:
| console.log(`Uploaded ${startByte + e.loaded} of ${startByte + e.total}`); | |
| console.log(`Enviado ${startByte + e.loaded} de ${startByte + e.total}`); |
| ``` | ||
|
|
||
| Here we send the server both file id as `X-File-Id`, so it knows which file we're uploading, and the starting byte as `X-Start-Byte`, so it knows we're not uploading it initially, but resuming. | ||
| Aqui enviamos ao servidor tanto o id do arquivo como `X-File-Id`, para que ele saiba qual arquivo estamos enviando, quanto o byte inicial como `X-Start-Byte`, para que ele saiba que não estamos enviando pela primeira vez, mas retomando. |
There was a problem hiding this comment.
Detalhe (opcional): como "tanto ... como" também é um par correlativo em português, a frase pode ser lida como "tanto o id do arquivo quanto o X-File-Id", e o "quanto" seguinte fica sem par. A ideia do original é que cada informação vai em um cabeçalho. Uma sugestão para evitar a ambiguidade:
| Aqui enviamos ao servidor tanto o id do arquivo como `X-File-Id`, para que ele saiba qual arquivo estamos enviando, quanto o byte inicial como `X-Start-Byte`, para que ele saiba que não estamos enviando pela primeira vez, mas retomando. | |
| Aqui enviamos ao servidor o id do arquivo no cabeçalho `X-File-Id`, para que ele saiba qual arquivo estamos enviando, e o byte inicial no cabeçalho `X-Start-Byte`, para que ele saiba que não estamos enviando pela primeira vez, mas retomando. |
| // poderíamos usar um caminho real em vez disso, por exemplo | ||
| // let filePath = path.join('/tmp', fileId); | ||
|
|
||
| debug("onUpload fileId: ", fileId); |
There was a problem hiding this comment.
Detalhe (opcional): as mensagens de depuração (debug(...)) deste arquivo continuaram em inglês, enquanto o console.log da linha 120 foi traduzido. Ficaram assim as linhas 25, 41, 53, 58, 68, 76 e 83 (por exemplo, "New file created", "File reopened", "Upload finished", "File unfinished, stopped at", "fileStream error"). Se a ideia for traduzir os textos do exemplo, vale incluir essas também, sempre mantendo os nomes de variáveis como fileId e bytesReceived.
Resumo
Traduz o artigo "Resumable file upload" para o português. Como a demo embutida via
[codetabs src="upload-resume"]é mostrada inline ao leitor como código para baixar, também traduziupload-resume.view/index.html,uploader.jseserver.js(comentários e os textos de status HTTP que o servidor retorna); as chamadas dedebug()(log interno do servidor, não visível ao leitor) ficaram como estão.Plano de teste
🤖 Generated with Claude Code